SpellCheck v1.4 - Copyright (c) 2002-2003 by Thomas Chapman
====================================================================

SpellCheck is distributed as shareware.  You can try it out, nag free, for 15 days. If you like the features and convenience of SpellCheck you should purchase SpellCheck and enjoy this great improvement to the usability of your palm!

You can get the full registered version for only $9.95 (US). Please see the end of this document for more information on purchasing SpellCheck for your palm.

Special thanks to:
	Kevin Atkinson & Alan Beale for the extensive word lists!
	Sam Kirchmeier for code to check word similarity!


Table of Contents
==================================================
1.  Introduction & Overview
2.  Disclaimer
3.  Content of the Zip archive
4.  System Requirements
5.  Installing and Upgrading
    1. Dictionary Details
    2. Dictionaries and External Memory Card's (SD, MMC, MemoryStick, etc...)
6.  Uninstalling
7.  Using the Program
    1. Setting up SpellCheck as a Drag&Drop Prefs Panel Extension Module
    2. Configuring SpellCheck
    3. Not in Dictionary
    4. The Custom Dictionary
    5. The Auto-Replace Dictionary
    6. The SpellCheck options
    7. Entering the Registration number
8.  Future Enhancement Ideas
9.  Bug Reporting
10. Registration
11. Versions & Changes
12. Known bugs/issues & workarounds
13. FAQ's



==================================================
1. Introduction & Overview

SpellCheck was designed to give you quick and easy access to a spell checker on your palm. This full featured spell checker is available anywhere and in any program! Simply click in the text you wish to check and draw the graffitti slash character to bring up the command bar where you can choose to spell check the text.

Spell checking your documents has never been easier or faster!  Give it a Try!



==================================================
2.  Disclaimer

This program has been tested on several popular Palm devices from Palm OS 2.0 to Palm OS 5.0. 

This program is provided without any warranty and the user accepts full responsibility for any damages, consequential or otherwise, resulting from its use.

This archive is freely redistributable, provided it is made available only in its complete, unmodified form with no additional files.



==================================================
3. The following files are included in the archive

	SpellCheck.prc			The application (REQUIRED)
	SpellCheck.txt			The file you are reading...
	AutoReplaceDB.pdb		A sample auto-replace dictionary. (not required for normal use)
	15,000 words.pdb		Dictionary with over 15,000 words.
	50,000 words.pdb		Dictionary with over 52,000 words.
	100,000 words.pdb  *		Dictionary with over 100,000 words.
	150,000 words.pdb  *		Dictionary with over 150,000 words.
	200,000 words.pdb  *		Dictionary with over 200,000 words.

	* Downloadable after purchase


==================================================
4. System Requirements

	Palm OS 2.0 or above.
	At least 180k available RAM memory. More RAM needed for bigger dictionaries.	



==================================================
5. Installing and Upgrading

   Installation
	Install the SpellCheck.prc and one of the dictionaries by using your Palm device install tool and then Hotsync.
	Install the AutoReplaceDB.pdb if you have the room on your palm and would like the spell checker to use it.

   UPGRADING:
	You can upgrade an older version of this program by Hotsyncing the new version over the top. All settings and preferences will remain.


5.1  Dictionary Details

   Here are the suggested uses for each dictionary size:

	15,000 - Use this dictionary only if you have limited space or if you plan on having a second larger dictionary on a memory card. (see section 5.2 below)

	50,000 - The minimum recommended size. A good set of the most common words.

	100,000 - Recommended medium sized dictionary. Includes many proper names.

	150,000 - Includes a lot of technical terms as well as a lot of strange affixations of common words.

	200,000 - Recommended large dictionary. Most words and proper names found in common dictionaries. great for putting on a memory card


   To give you an idea of what the words in the various sizes look like here is a sample of random words found in that size and higher:

	15,000 - afternoon assumed balancing ban bearing begins brilliantly broadcasting brown candidate chancellor chain competition degraded delays donations dug emergency excuses fear full gut homes ignoring imaginary influenced investigations is laboratory lean likely mayor mind paperback parked paths performs represents rescue shortly small space specifically speculate steal stick stole takers usage warehouse

	50,000 - adjoins affinities bale conspirators crowed dames denoted dictatorships eccentricities employments fulling golfer gyrations hierarchies kitchens lash masticate moratorium overestimate preach rhododendrons scaffolding swirl tornadoes welders

	100,000 - alder allspices augury careening dentins dollops earmuff gauziest handballs invitingly minibike paramilitary pertly pluckiness popes reapply sachets scribblers swaddle sweetbreads topographic undervalues unleaded wineries wordinesses

	150,000 - armorials bimolecularly birefringence camerawoman clerestories congregationalisms coupler dreg ductility extortioners forebodingly gingerliness goldbricks grader haircloth harpings inappreciably incomprehensibleness intolerability intransitiveness intubates inseparabilities kinesics metacarpi metallurgic millijoules narratology negativism oarswomen opinionatedness outdoorsy predigested pruners railer religiosity restoratively retiredness roguishness selfness shatterproof simplemindedness teated thereunto tupelo typedefs unbodied unmurmuring unstuffy upstandingness yearlong 

	200,000 - stragal cisterna copolymer counterstamp cuneal enchiridion enphytotic headsail jailhouse krait lobo miliary nubbly obsecrate oculus palladic phalangeal retroaction sialoid skiplane subtangent sudoriferous surmullet tupelo vaporish


5.2  Dictionaries and External Memory Card's (SD, MMC, MemoryStick, etc...)
	It is recommended that if you would like to use a memory card to store your large dictionary you do the following:
	1. Install the 15,000 word dictionary to your palm's main memory for speed.
	2. Install the larger dictionary to the memory card.

	If you follow the above steps, SpellCheck will have the following advantages:
	1. The large dictionary will be used only when the word is not found in the smaller dictionary.
	2. You will not see a significant decrease in the speed of the spellchecker.
	3. SpellCheck will still work, with the limited word set, without the card inserted.
	
	WARNING: Putting the dictionary ONLY on an external memory card can cause the spell check to take about 2.5 times longer. You should have a smaller dictionary in main memory to prevent this!

	NOTE: If you install from a HotSync to your Memory card, the dictionary will be put in the proper location. (/PALM/Launcher)



--------------------------------------------------
  Word lists are Copyright 2000 by Kevin Atkinson

  Permission to use, copy, modify, distribute and sell these word
  lists, the associated scripts, the output created from the scripts,
  and its documentation for any purpose is hereby granted without fee,
  provided that the above copyright notice appears in all copies and
  that both that copyright notice and this permission notice appear in
  supporting documentation. Kevin Atkinson makes no representations
  about the suitability of this array for any purpose. It is provided
  "as is" without express or implied warranty.
--------------------------------------------------




==================================================
6. Uninstalling

	Delete SpellCheck from within the Application Launcher.
	All dictionaries, settings, and preferences will be removed from main memory when you delete the application.
	
	You will need to delete the dictionary from the external memory card manually.

	NOTE: If you are unable to Delete SpellCheck from your palm, you most likely have the Preference "Graffiti ABC double-click" enabled. Go into SpellCheck Preferences and Uncheck this option. You should now be able to delete SpellCheck from your palm.



==================================================
7. Using the program

	Using the program is easy. Once it is installed, you simply use your palm as you have before.
	
   There are several ways to activate a SpellCheck:
	1. On a palm with OS 3.5 or above, In any program with an edit field, when this field is active, the Menu Command bar will have a SpellCheck option on it. The Menu Command bar can be accessed by writing a / in the graffiti area. Select the Spell check button on the Menu command bar to activate SpellCheck.
	2. If "Graffiti ABC" is activated under preferences, you can double click the ABC in the Graffiti area to activate a spell check.
	3. SpellCheck is available to the Drag&Drop program as an extension module. You must first go into Drag&Drop and search for extra modules. (See Drag&Drop in Section 7.1 of this document for more info)
	4. You can copy and paste words into the SpellCheck program and click the Spell Check button to check the words.
	5. You can enter words into the SpellCheck program and click the Spell Check button to check the words.

   On Palm devices with OS 3.5 and above
	When you enter the Menu Command character "/", starting the stroke at the bottom, it will bring up the Menu Command Bar. This bar usually will have several icons on it. When SpellCheck is installed, and when a text field is selected, this Menu command bar will include the SpellCheck icon as well. (The SpellCheck icon has "ABC" on it and a Checkmark)
	NOTE: If you have a field selected and SpellCheck does not show, start the SpellCheck application and return to try spell checking again. (The SpellCheck application must be run at least once to setup the handheld)

   On Palm devices before Palm OS 3.5,
	You have two options:
	  1. It is highly recommended that you enable the "Graffiti ABC double-click" option.
	  2. Or you can install and use the Drag&Drop program available from the following website:   http://www.umap.net/MacPalm/Soft/DragDrop/index.html

   Fields that SpellCheck cannot correct
	If the field cannot be changed, then SpellCheck will not be an option on that field. Just like the Palm OS will not let you Paste to a non-editable field, SpellCheck will not be active when you have text selected in these types of fields.
	
   NOTE for HandSpring Treo Owners:
	A Handspring Treo with a keyboard does not have a standard Command Menu Bar. There is not an obvious way to activate SpellCheck from within programs on the Treo.
	To work around this problem, Handspring allows you access to a Free download called RecoEcho. Download and Install this program to your Treo. This program allows writing graffiti strokes on the Treo screen, and allows the Command Menu to be brought up like on a graffiti enable device.
	You can download RecoEcho From: http://support.handspring.com/esupport/forms/hsResolutionView.jsp?ResolutionId=8788



7.1  Setting up SpellCheck as a Drag&Drop Prefs Panel Extension Module

	Drag&Drop can be found here:
	http://www.umap.net/MacPalm/Soft/DragDrop/index.html

	1. Install the Drag&Drop Utility and get it enabled and working.

	2. You need to setup Drag&Drop to recognize SpellCheck as an extension module. 
		a. Go into the Prefs panel and select Drag & Drop.
		b. Make sure the "Copy selected text when tapped" option is turned off within Drag&Drop.
		c. Click on the "Module" tab at the top of the screen.
		d. Click on the Search button and let it run.
		e. SpellCheck should show up as one of the options, make sure it is checked.
		f. You are now ready to use Drag&Drop.

	NOTE: If the Drag&Drop setup did not work for you, Please see the Drag&Drop manual as to how to set this up. Also try using the standard SimpleModule.prc as practice setting up Drag&Drop.
	
	3. Now lets try it out! Go into MemoPad, and open a memo to spell check.
	4. Now drag and select the text that you wish to check.
	5. With the text selected, click within the selection to bring up a small menu of options.
	6. Choose "SpellCheck" and the selected text will be checked.


7.3 Not in Dictionary

	The word that was not found in the dictionary is highlighted in the field at the top of this window.
	You can manually edit the word on the edit line, or pick a word from the suggestions list.

   The Buttons
	Change - Changes the highlighted error to the word on the edit line. This word will be automatically replaced if found again in this text.
	Ignore - Leaves the highlighted error unchanged and continues to check the text. This word will also be automatically ignored if found again in this text.
	Add - Adds the highlighted word from the original text to the custom dictionary.
	Lookup - Takes the word on the edit line and looks it up in the dictionary. If it is found, it will be highlighted in the suggestion list. If the word was not found in the dictionary, a suggestion list will be created for this word.
	Done - Closes the spell checker, and saves any changes you have made.

   Suggestions
	The progress bar shows the words being collected to show in the suggestion list. The rest of the dialog is active even when it is collecting words.

7.4 The Custom Dictionary

	You can activate/deactivate the custom dictionary from the Preferences screen.
	When you edit the custom dictionary, you can add and remove words from the custom dictionary.
	
   Adding Words
	Type the word and hit add to add this word to the dictionary. Normally you would enter each word in all lowercase letters. This way, the case checking function of the dictionary works properly. Only capitalize words that normally would be capitalized.
	NOTE: If you add a word with capital letters and then enter it with lowercase letters, the lowercase letter spelling of the word will replace the capitalized word.

   Removing Words
	To remove a word from the dictionary, click on the word in the list and press remove.
	
   Database Location
	NOTE: The Custom dictionary should remain in the main RAM memory of your palm handheld. It will not work properly if it is moved to flash or a card.


7.5 The Auto-Replace Dictionary

	A sample auto-replace dictionary is included in the archive. Feel free to use this, add to it, or erase it. Install it to your palm handheld in the main RAM memory.

	You can activate/deactivate the auto-replace dictionary from the Preferences screen.

   Adding Words
	When you edit the auto-replace dictionary, you can add and remove words from the auto-replace dictionary.
	The words in the auto-replace dictionary will be replaced while the spelling checks are made. Type the word and the replacement word and press the Add button to add these words to the auto-replace dictionary. Normally you would enter each word in all lowercase letters. This way, the case checking function of the dictionary works properly. Only capitalize words that normally would be capitalized.
	NOTE: If you add a word with capital letters and then enter it with lowercase letters, the lowercase letter spelling of the word will replace the capitalized word.

   Removing Words
	To remove a word pair from the dictionary, click on the word in the table and press remove.

   Database Location
	NOTE: The Auto-Replace dictionary should remain in the main RAM memory of your palm handheld. It will not work properly if it is moved to flash or a card.


7.6 The SpellCheck Preferences and Options

	There are several ways to get into the SpellCheck Preferences:
	1. From the SpellCheck Main screen, open the menu and choose Preferences from the options menu.
	2. From the SpellCheck "Not in Dictionary" dialog, open the menu and choose Preferences from the options menu.
	3. From the SpellCheck "Progress" Dialog, choose the "Options..." button.
	
   Preferences
	Press the "SpellCheck options" button to view and change how the spell checker works. See Options below...
	Check the box "Use custom dictionary"  if you wish to use the custom dictionary when spell checking a document.
	Press the "Edit custom dictionary" to add and remove items from the custom dictionary.
	Check the box "Enable auto-replace" if you want auto-replace to be active when spell checking a document.
	Press the "Edit auto-replace" button to add and remove items from the auto-replace dictionary.
	Check the box "Graffiti ABC" if you would like to be able to spell check from within any application by double clicking on the ABC "keyboard icon" in the graffiti area.  NOTE: As long as this box is enabled, you will not be able to delete SpellCheck from your palm. Simply uncheck the box and you will be able to delete SpellCheck.
	Use the Registration button to enter the registration number received after purchasing SpellCheck.

   Options
	These options modify the way the spell checker works. Most of these options affect the speed of spell checking.
	
	The options are as follows:
	Choose "Case sensitive spell check" to catch the words that should be capitalized.
	Choose "Ignore words with numbers" to skip words that contain a number like 5dogs, 4sale, you8beef, etc...
	Choose "Ignore mixedCase words" to skip words like UpTown, BackStreet, UpdateDisplay, etc... where the words are put together by capitalizing each word.
	Choose "Ignore UPPERCASE words" to ignore words that are spelled with all capital letters.
	Choose "Ignore Capitalized words" if you would like to skip all capitalized words.
	Choose "Beep when finished" if you would like the spell checker to beep when it has finished.


7.7 Entering the Registration number

	After you bring up the Preferences dialog, choose the "Register..." button.
	Enter the registration number and press OK.




==================================================
8. Future Enhancement Ideas

	* Save main screen text as an option
	* Support larger fonts
	* Check spaces and capitals on first words
	* Check for double words
	* Ignore Internet URLs, Filenames, and Email addresses.
	* Compressed dictionaries
	* Add the SpellCheck option to the Edit Menu
	* Document Statistics (character count, word count, sentence count, average word length, etc...)
	* Full version with dictionaries in German, French, Spanish, and Italian.

	NOTE: Your ideas are welcome!



==================================================
9. Bug Reporting

	To report a bug, or make a suggestion, you can contact me at:

	tcchap@hotmail.com



==================================================
10. Registration

This program is shareware.  The unregistered version is nag free for 15 days, then you must register the program to turn off the nag screens.

If you like the program and wish to get a code to unlock the program, follow the instructions below.

Registering will provide you the following:
	A code to unlock your version of SpellCheck for no more Nag Screens!
	Access to download the full version with large dictionaries.

Registration is $9.95 (US)

Registration is available through several services:

http://www.Handango.com
	1. Search for "SpellCheck".
	2. Click "Add to Cart".
	3. Purchase SpellCheck.
	4. You will receive a Registration Code that will validate your copy of SpellCheck.

or

http://www.palmgear.com
	1. Search for "SpellCheck".
	2. Click on the "Buy" Button.
	3. Purchase SpellCheck.
	4. You will receive a Registration Code that will validate your copy of SpellCheck.

or

http://www.paypal.com/

	PayPal allows you to send money to anyone with an email address. 

	1. Sign-in, and click Send Money, 
	2. Enter my email address (tcchap@hotmail.com) as the recipient 
	3. Enter $9.95 as the amount you wish to send.
	4. In the note mention that this payment is for a SpellCheck Registration.
	5. You can pay with a credit card or checking account. 
	6. I will get an email that says "Youve Got Cash!"
	7. I will then send you a Registration Code that will validate your copy of SpellCheck.


or, If none of the above options will work for you, write me and I will send you an address where you can send a money order...



==================================================
11. Versions & Changes

1.4 - 01/17/03	- Graffiti ABC double-click option now available under Palm OS 5.0
		- Hints for Handspring Treo owners in the document.

1.3 - 01/14/03	- Palm OS 5.0 Compatible

1.2 - 09/04/02	- Fixes for multi-byte character sets.
		- Removed unregister on HotSync start.
		- Fixed checking numbers, with "Ignore words with numbers" turned off.

1.1 - 08/31/02	- Fixed custom dictionary activate while checking.
		- No longer allow spell checking fields that are empty or not editable.
		- Warn user if corrected text exceeds field length.
		- Fixed the info help from the Selected Text Alert.
		- The Command Menu Bar will now clear from the correction dialog.
		- Gracefully handle hidden text fields.

1.0 - 08/30/02	- Initial release.  



==================================================
12. Known bugs/issues & workarounds, if available:

   - SpellCheck does not work with "WordToGo"
	Problem: WordToGo provides its own on-screen text display, which is not a standard text field. SpellCheck has only partial access to this text through a hidden text field.
	Workaround: The user must copy and paste the text into the SpellCheck Application to perform a spell check.

   - "SheetsToGo" does not show the corrected text after a SpellCheck is performed.
	Problem: SheetsToGo does not use standard methods to display the Menu Command bar, or to handle cut, copy, paste, etc... 
	Workaround: When you enter text in a cell, you must click the check mark to save that text before spellchecking the field. If you do not save the text first, it may not show up after the spellcheck is performed.

   - "SlideshowToGo" does not respond after a SpellCheck is performed.
	Problem: SlideshowToGo looses focus when SpellCheck is run, and its event loop never recovers.
	Workaround: You can click on the Applications soft key to go to the launcher and start SlideshowToGo again. Your corrected text and document will be recovered.  It is probably best to not use Spellcheck with SlideshowToGo.

   - Handspring Treo with a keyboard does not have a standard Command Menu Bar.
	Problem: There is not an obvious way to activate SpellCheck from within programs on the Treo.
	Workaround: Handspring allows you access to a Free download called RecoEcho. Download and Install this program to your Treo. This program allows writing graffiti strokes on the Treo screen, and allows the Command Menu to be brought up like on a graffiti enable device.
	Download RecoEcho From: http://support.handspring.com/esupport/forms/hsResolutionView.jsp?ResolutionId=8788



==================================================
13. FAQ's

Q:	I am unable to delete SpellCheck from my palm.
A:	You most likely have the Preference "Graffiti ABC double-click" enabled. Go into SpellCheck Preferences and uncheck this option. You should now be able to delete SpellCheck from your palm.

Q:	My Dictionary is on an External Memory card, but it is REALLY Slow! Is there anything I can do?
A:	See the section "5.2  Dictionaries and External Memory Card's (SD, MMC, MemoryStick, etc...)" for help!

Q:	After I Beam SpellCheck to someone, it is not active. I cannot get it to do a spell check from XYZ program.
A:	The SpellCheck Application must be run at least once to activate it. Run SpellCheck and then try spell checking from your favorite application. SpellCheck automatically activates after a Hotsync.

Q:	I am unable to activate SpellCheck on my Handspring Treo. My Treo has a keyboard, and the Command Menu bar is not the same as a Graffiti device.
A:	See the Treo section in "7. Using the program" or "12. Known bugs/issues & workarounds" listed above for a solution for Treo Owners.
